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FOREWORD 


I 


An  important  finding  of  the  Navy  Enlisted  Occupa- 
tional Classification  System  (NEOCS)  study  "as  the 
existence  of  a significant  "gap”  between  the  reading 
comprehension  level  of  technical  manuals  and  the 
reading  abilities  of  new  Navy  technicians.  The  Navy  is 
"narrowing”  this  gap  via  a wide  ranging  research 
program  including,  for  example,  remedial  training,  new 
media  techniques  and  simplified  technical  manuals.  One 
part  of  this  program  deals  specifically  with  the  objective 
of  improving  the  reading  comprehension  level  of  main- 
tenance manuals.  The  project  reported  here  is  concerned 
with  that  objective. 

This  report,  the  first  of  three  products  to  be 
delivered,  presents  requirements  and  criteria  to  be  used 
by  technical  writers  to  improve  the  readability  and 
comprehensibility  of  their  manuscripts.  The  require- 
ments and  criteria  presented  here: 

1 . can  be  used  to  guide  the  original  preparation  of 
technical  manuscripts  or  to  determine  whether 
an  existing  manual  needs  “rewriting"  to  bring  its 
reading  comprehension  to  an  acceptable  level; 

2.  go  considerably  beyond  the  traditional  province 
of  readability  in  that  they  address  organization 


and  communication  variables  as  well  as  nonprose 
presentations;  and 

3.  must  be  tested  to  determine  their  impact  on  new 
Navy  technicians  with  respect  to  performance  of 
maintenance,  understanding  of  the  system,  and 
acceptability  of  the  new  manual. 

BioTechnology , Inc.  is  developing  two  companion 
products  to  this  report.  The  first  product  specifies  the 
impact  these  requirements  and  criteria  will  have  on  an 
existing  maintenance  manual.  This  impact  will  be  shown 
in  terms  of  a “book  plan,”  a detailed  outline  of  what 
this  manual  will  look  like  when  rewritten  in  accordance 
with  the  requirements  and  criteria  presented  here.  The 
second  product  is  a test  plan  for  evaluating  the  rewritten 
manual.  The  test  plan  will  lie  designed  to  point  up  the 
benefits  which  might  accrue  from  a larger  scale  applica- 
tion of  such  a reading  comprehension  improvement 
program. 

This  study  is  being  conducted  for  Naval  Sea  Systems 
Command,  Code  0463.  The  technical  monitor  for  the 
Navy  is  Mr.  William  Shihda;  the  principal  investigators 
from  BioTechnology,  Inc.  are  Mr.  Theodore  J.  Post  and 
Mr.  Harold  E.  Price. 
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INTRODUCTION 


Background  and  Problem 

Maintenance  manuals  are  intended  to  provide  techni- 
cians with  the  information  they  need  to  maintain  the 
equipment  assigned  to  their  care.  Unfortunately,  many 
technicians  do  not  use  the  manuals  to  support  their  job 
performance.  The  Navy  has  conducted  research  intended 
to  identify  manual  problems  that  could  be  causing  this 
poor  utilization.  Some  candidate  problems  deal  w ith  the 
technical  accuracy  and  completeness  of  manual  informa- 
tion; other  problems  deal  with  certain  of  the  manual's 
physical  attributes  such  as  size  and  weight;  still  others 
concern  the  currency  of  the  information.  The  hope  is 
that  by  solving  problems  such  as  these,  more  technicians 
will  be  inclined  to  use  the  manual  more  often.  However, 
increasing  the  technician’s  willingness  to  use  the  manual 
will  not  improve  technician  performance  unless  the 
technicians  are  able  to  understand  the  guidance  offered 
by  the  manuals.  The  material  which  follows  is  intended 
to  help  technical  writers  maximize  the  understandability 
of  their  manuals. 

Approach 

The  problems  which  cloud  manual  understandability 
must  be  identified  before  any  improvement  can  be 
attempted.  Our  approach  assumes  that  the  information 
which  specifications  prescribe  for  maintenance  manuals 
is  adequate  but  that  its  method  of  presentation  causes 
understandability  problems.  The  specific  presentation 
aspects  responsible  for  this  difficulty  follow. 

Organization 

The  arrangement  of  content  in  conventional  main- 
tenance manuals  may  be  logical  but  not  particularly 
relevant  to  the  technician’s  job.  This  disparity  causes 
excessive  search  time,  a major  user  complaint  about 
technical  manuals.  In  addition,  once  the  user  locates  the 
several  manual  passages  containing  the  relevant  informa- 
tion, he  must  undertake  a “gathering  and  collation” 
procedure  which  is  especially  difficult  for  users  in  the 
lower  ability  ranges. 


Communication  Adequacy 

The  adequacy  with  which  the  manual  communicates 
technical  information  to  the  technician  is  -a  function  of 
both  the  amount  and  type  of  information.  Communica- 
tion will  be  impaired  when;  (l)the  information  is  too 
complex,  (2)  there  is  too  much  detail,  or  (3)  too  much 
of  the  information  is  irrelevant.  Communication  also 
suffers  when  the  balance  between  graphics  and  prose  is 
improper  or  the  guidance  for  the  technician  is  either  too 
implicit  or  too  explicit. 

Readability  of  Prose  Material 

Technicians  complain  that  reading  manuals  is 
difficult  even  when  less  than  half  of  the  manual's  pages 
are  continuous  prose.  For  example,  the  readability  of 
prose  in  representative  manuals  has  been  estimated  at 
the  12th  to  14th  grade  level.  This  means  that  users  must 
possess  the  reading  skill  associated  with  12th  to 
14th  graders  if  reasonable  comprehension  is  to  be 
achieved  (usually  75  percent  correct  on  a comprehension 
test).  Users  possessing  more  limited  reading  skills  can  be 
expected  to  comprehend  less  of  the  included  material. 
The  results  of  testing  representative  maintenance  techni- 
cians indicate  that  their  reading  abilities  correspond  to 
those  of  9th  grade  students.  This  “gap  of  three  to  five 
grade  levels  causes  comprehension  and  attitude  problems 
which  contribute  to  the  low  utilization  of  manuals. 

The  material  in  this  document  is  intended  to  help 
you  identify  and  resolve  technical  manual  problems  of 
the  types  described  above.  Specifically,  this  document 
presents  the  requirements  and  criteria  for  presenting 
information  which  the  user  can  access,  read,  and 
understand.  The  rationale  underlying  the  requirements  is 
presented  and  the  criteria  for  meeting  each  requirement 
are  developed  in  the  form  of  tests.  The  tests  address  the 
characteristics  your  manual  should  have  if  it  is  not  to 
suffer  from  the  problems  described  above.  Criteria 
within  each  test  have  been  italicized  for  emphasis. 
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Corrective  actions  are  also  suggested  when  such  actions 
are  not  obvious  from  the  criteria  statements.  Finally,  the 
tests  are  designed  to  be  applied  to  completed 
maintenance  manuals,  either  preliminary  drafts  (viz., 
in-process  reviews)  or  operational  manuals  (viz., 
determine  the  need  for  rewrite). 

General  Rewrite  Practices 

In  addition  to  the  detailed  tests  described  above, 
supplemental  rewrite  practices  are  included  in  a final 
section.  These  are  general  writing  practices.  The  use  of 
these  practices  should  heighten  the  user  s understanding 
and  acceptance  of  the  manual.  These  general  practices 
are  not  intended  to  be  used  in  deciding  whether  to 
rewrite  an  existing  manual.  This  decision  should  be  made 
on  the  basis  of  the  principal  requirements  and  criteria 
discussed  above.  Once  a decision  is  made  to  rewrite  a 
manual,  however,  these  general  practices  should  be 
included  in  the  rewriting. 


Test  Procedures 

Apply  the  three  sets  of  tests  in  the  following  order: 
organization,  technical  communication,  and  readability. 
This  sequence  reflects  an  efficient  process  rather  than 
relative  importance.  Descriptive  material  provided  for 
each  test  set  includes: 

a.  Discussion  of  the  purpose  of  each  test  and  how  it 
should  be  applied. 

b.  Specific  criteria  the  manuscript  must  meet  and 
corrective  actions  to  take  when  the  tests  uncover 
manual  deficiencies. 

c.  Examples  illustrating  good  and  bad  use  of  the 
test  criteria. 

d.  A summary  of  the  requirements  and  criteria 
intended  for  use  after  you  have  become  familiar 
with  the  supporting  discussions.  These 
summaries  are  consolidated  in  the  next  to  last 
section. 


ORGANIZATION  REQUIREMENTS 


Rationale 


Technicians  expect  maintenance  manuals  to  provide 
information  that  will  help  them  do  their  job.  The 
information  in  the  manuals  should  therefore  be 
accessible  via  job-relevant  terms,  that  is,  the  equipment 
units  and  the  maintenance  actions  the  technicians 
perform  on  each  unit.  The  technician's  need  for  informa- 
tion frequently  includes  more  than  one  "maintainable 
unit”  and  more  than  one  maintenance  action.  For 
example,  to  help  isolate  the  cause  of  a malfunction,  he 
may  need  information  on  progressively  smaller  maintain- 
able units,  often  proceeding  from  the  total  system  to  the 
piece  part  level.  The  technician's  information  need 
invariably  involves  a succession  of  maintenance  actions 
applied  to  progressively  smaller  units  in  the  system 
hierarchy  (e.g.,  consecutive  troubleshooting  actions  con- 
cluded by  replace,  calibrate,  and  checkout  actions). 
Accordingly,  the  organization  of  the  manual  should 
emphasize  the  hierarchy  of  maintainable  units,  the 
maintenance  actions  applicable  to  each  maintainable 
unit,  and  the  required  sequences  of  maintenance  actions. 


the  adequacy  of  its  organization.  The  discussions  also 
suggest  practices  to  correct  any  deficiencies  you 
uncover. 


Requirements 

Four  principal  requirements  apply 
technical  manual  organization: 


to  effective 


The  organization  of  the  manual  should  be  based 
on  a hierarchy  of  maintainable  units. 


Repair  cycle  overviews  should  be  presented. 
These  should  he  diagrammatic  representations  of 
the  succession  of  maintenance  actions. 

All  information  about  a maintainable  unit  should 
be  consolidated  into  a single  package. 

The  content,  format,  and  sequence  of  informa- 
tion within  a package  should  be  standardized. 


The  following  material  is  a discussion  and  illustration 
of  tests  you  should  apply  to  your  manual  to  determine 


The  following  material  expands  these  four  require- 
ments in  terms  of  tests  and  criteria  that  will  bring  a 
poorly  organized  manual  into  compliance  with  a job- 
relevant  organization. 


Test  1.  Maintainable  Units  Review 


A manual  organization  preferred  lor  its  access  and  lions  like  these  tend  to  provide  information  about  a 

consistency  consolidates  in  on'  location  all  information  maintainable  unit  in  several  different  locations  in  a 

about  a maintainable  unit.  Such  a manual  ran  be  manual,  especially  where  such  items  as  principles  of 

produced  only  when  the  primary  basis  for  organization  operation  and  troubleshooting  are  concerned.  Also,  the 

is  maintainable  units  rather  than  types  of  information.  emphasis  which  the  early  sections  give  to  hardware  units 

Review  the  table  of  contents  and  the  manual  itself  to  vanishes  as  the  manual  begins  to  present  job  supporting 

see  whether  the  manual  emphasizes  maintainable  units.  procedures.  Such  organizations  preclude  easy  access  to 

The  top  level  maintainable  unit  may  be  the  entire  key  procedural  information,  e.g.,  Figure  I -I  "buries" 

system,  a subsystem,  or  a major  equipment  end  item.  150 pages  of  critical  troubleshooting  schematics  in 

The  successive  breakdown  into  smaller  maintainable  sections  5-4  and  5-5.  Similarly.  Figure  1-2  shows  how 

units  should  be  based  primarily  on  functional  considera-  Id  pages  of  schematics  are  buried  under  the  heading  of 

tions  for  isolating  units  during  troubleshooting.  The  key  "Troubleshooting.  Figure  1-3  is  an  example  of  a partial 

step  in  correcting  poor  organizations  is  to  obtain  or  table  ol  contents  organized  around  maintainable  units. 

develop  a “family  tree ” or  topdown  breakdown  of  the  Ihe  pertinent  document  emphasizes  troubleshooting 

system  in  terms  of  maintainable  units.  information  although  nontroubleshooting  materials  are 

Figures  1-1  and  1-2  show  sample  tables  of  content  quite  easily  incorporated. 


which  do  not  emnhasize  maintainable  units.  Orffaniza- 


SECTION  4 PRINCIPLES  OF  OPERATION 
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Test  2.  Subordination  of  Units  Review 


A maintenance  manual  organized  around  maintain- 
able units  facilitates  user  access  and  also  results  in  a 
subordination  structure  compatible  with  effective 
troubleshooting. 

Maintenance  manuals  which  ignore  functional  group- 
ings of  equipment  in  favor  of  hardware  packages  often 
contain  lengthy  troubleshooting  sequences  sometimes 
requiring  as  many  as  100  to  125  steps.  Procedural 
sequences  of  even  one-third  this  length  cause  problems 
for  technicians  and  technical  writers.  Where  possible , the 
ratio  of  superordinate  to  subordinate  units  should  be  in 
the  order  of  I to  5,  or  1 to  10.  Such  a subordination 
results  in  relatively  short  troubleshooting  sequences. 

Figure  2-1  illustrates  the  different  levels  of  subordi- 
nation between  a maintainable  unit  orientation  and  a 
hardware  packaging  orientation.  The  example  is  based 


on  a manual  which  did  not  contain  a family  tree  or 
hierarchy  of  maintainable  units.  The  equipment  items 
appearing  in  the  left-hand  illustration  are  the  first 
breakout  of  maintainable  units  under  the  total  system. 
This  means  that  overall  troubleshooting  must  isolate  a 
malfunction  to  one  of  30  units,  a process  that  could 
require  two,  three,  or  even  four  times  that  many  steps. 
The  illustration  on  the  right-hand  of  Figure  2-1  shows  an 
alternative  hierarchical  arrangement  of  maintainable 
units  (less  chassis  and  power  supply  units).  This 
hierarchy  of  maintainable  units  has  the  advantage  of 
initially  isolating  system  malfunctions  to  one  of  three 
units  rather  than  to  one  of  30  units.  This  arrangement 
also  corresponds  more  closely  with  the  “principles  of 
operation”  discussion  appearing  elsewhere  in  the 
manual,  and  the  “troubleshooting  schematics”  in 
subsequent  sections,  both  of  which  are  functionally 
oriented. 


Hardware  Packaging 

Organization  Maintainable  Unit  Organization 


ire  2-1.  Comparison  of  Hardware  Packaging  and  Functional  Organizations. 


Test  3.  Repair  Cycle  Overview  Check 


The  comprehensibility  of  all  technical  writing  is 
enhanced  by  providing  “overview”  information.  This 
overview  helps  the  technician  become  familiar  with  the 
complete  set  of  maintenance  actions  required  to 
complete  a cycle;  it  also  helps  him  to  work  his  way 
through  an  otherwise  unrelated  set  of  procedural 
descriptions.  In  the  present  case , where  the  intent  is 
primarily  job-oriented  or  procedural,  the  overview 
should  diagrammatically  show  sequences  within  the 
maintenance  cycle  or  the  succession  of  maintenance 
actions  required  to  complete  a cycle.  Further,  several 
different  levels  of  overviews  may  be  required  for  larger 
systems. 

Figure  3-1  illustrates  a good  repair  cycle  overview.  It 
is  diagrammatic,  it  shows  different  levels  of  main- 
tenance, and  it  presents  the  succession  of  maintenance 
actions. 

Figure  3-2  is  a sample  overview  which  violates  a key 
principle  above;  viz.,  a diagrammatic  version  is  required, 
either  instead  of  or  in  support  of  any  narrative.  The 
diagrammatic  presentation  is  more  concise;  it  shows 
sequential  relationships  better  than  prose;  and  it  does 
not  “bury”  the  important  points  within  the 


word/ paragraph  format.  Additional  disadvantages  of 
relying  too  heavily  on  an  all  prose  presentation  are: 
(l)the  use  of  prose  encourages  generalities  (e.g.,  the 
underlined  phrase  in  Figure  3-2  calling  out  the  impor- 
tance of  Section  4),  and  (2)  the  tendency  in  prose  to 
group  unrelated  topics  as  though  they  were  related  (e.g., 
in  Figure  3-2,  overall  troubleshooting  strategy  is  mixed 
with  some  general  rules  to  observe  when 
troubleshooting). 

Figure  3-3  is  a corrected  version  of  Figure  3-2 
showing  the  elimination  of  two  of  the  violations 
described  above.  The  overview  is  diagrammatic  and 
refers  to  specific  equipment-oriented  checks  or  repairs. 
As  shown,  the  overall  checks  can  indict  one  of  three 
functional  groupings  of  system  equipment  as  the  cause 
of  a malfunction.  Troubleshooting  the  Symbol  Genera- 
tor Section  (Q)  isolates  the  cause  to  one  of  seven  major 
units.  These  might  be  replaced  if  the  need  is  urgent  and 
if  spares  are  available,  or  the  trouble  analysis  may 
continue  as  illustrated  in  the  case  of  the  Azimuth  Mark 
Generator.  In  addition  to  guiding  the  Ies6  experienced 
technicians  through  the  troubleshooting  process,  these 
overviews,  called  “organized  sequences,”  are  relatively 
easy  to  learn. 
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Troubleshooting  Data  Coverage,  AN/AQA-7  Subsystem 


Figure  3-1.  Sample  Overview  of  a Portion  of  a Maintenance  Cycle. 


••  PROCEDURE.  - Before  attempting  to  troubleshoot  the  AN/WSA-1C, 
determine  whether  the  source  of  the  trouble  is  external  or  internal.  Carefully 
check  all  switches,  both  on  the  C V-933/ WSA- 1C  and  on  the  control -indicator  units 
to  ascertain  that  they  are  in  the  correct  operating  position.  In  addition,  make 
certain  that  the  voltage  and  timing  for  all  inputs  are  correct.  Refer  to  the 
functional  block  diagram,  figure  5-1,  and  to  the  primary  power  distribution 
diagram,  figure  5-2,  to  aid  in  this  determination.  Familiarity  with  these  basic 
diagrams  and  the  principles  of  operation  discussed  in  Section  4 is  essential  to 
aervice  the  equipment  properly.  The  advisability  of  applying  power  to  defective 
equipment  should  be  carefully  considered  from  the  standpoint  of  causing  danger 
to  personnel  and  further  damage  to  the  equipment. 

After  the  trouble  has  been  determined  to  be  internal,  the  AN/USM-105  oscillo- 
scope should  be  used  to  compare  the  waveforms  given  in  the  troubleshooting 
charts,  on  the  schematic  diagrams,  and  in  the  waveform  charts  with  the  wave- 
forms in  the  equipment.  It  is  important  to  use  the  AN/USM-105  because  many 
of  the  waveforms  present  in  the  equipment  are  very  fast  pulses  which  will  not  be 
displayed  properly  on  an  oscilloscope  with  a bandpass  of  less  than  15  megacycles. 
Waveform  comparisons  are  the  most  effective  method  of  servicing  this  equipment. 
Resistance  measurements  made  on  transistor  circuits  have  little  value  because 
of  the  low- impedance  and  current- sensitive  properties  of  transistors.  When  a 
component  is  replaced  on  a printed  circuit  card  on  which  an  adjustment  is  located, 
the  setting  of  the  adjustment  should  be  verified  by  reference  to  the  alignment 
procedure  in  Section  6. 

CAUTION 

Before  replacing  components  located  on  a printed  circuit  card, 
study  the  instructions  for  printed  circuit  repair  given  in  Section  6. 
Improper  repair  techniques  may  damage  or  destroy  printed 
circuit  cards. 

It  is  important  when  making  waveform,  voltage,  or  resistance  measurements 
that  the  controls  on  the  equipment  and  test  equipment  be  set  as  required  for  the 
test.  When  the  trouble  has  been  found  to  be  the  result  of  a defective  printed 
circuit  card,  the  defective  component  or  components  should  be  located  by  a 
careful  analysis  using  the  waveform  and  voltage  data.  This  equipment  has  no 
parts  with  the  exception  of  light  bulbs  which  have  a definite  limited  life;  there, 
fore,  before  replacing  a printed  circuit  card  or  component  it  should  be  determined 
that  the  voltages  into  the  printed  circuit  card  are  of  the  proper  value  to  insure 
that  the  component  failure  was  not  caused  by  a failure  elsewhere  in  the  equipment. 


Figure  3-2.  Illustration  (partial)  of  a Poor  Repair  Cycle  Overview. 


Conduct 

Inter  nal/External 


Figure  i-.'i.  Preferred  Presentation  of  Repair  Cycle  Overview . 


Test  4.  Consolidation  Check 


l !scrs  object  to  being  referred  from  section  to  information  about  a maintainable  unit  in  one  location  or 
section  of  the  manual.  They  prefer  an  arrangement  package. 
whereby  all  information  for  a particular  job  is  in  one 

place.  In  addition  to  providing  a single  source,  thereby  Figure  4-)  lists  the  different  manual  sections  cover- 
easing access,  the  technician  will  know  that  if  the  jng  the  Kamp  Generator,  a major  unit  of  a sample 

information  he  seeks  is  not  in  the  designated  package,  it  system.  Consolidating  this  information  in  one  package, 

dues  not  exist  in  the  manual.  even  if  no  other  changes  are  made,  will  substantially 

improve  the  users  access.  In  addition,  it  must  be 
Scan  the  table  of  contents  and  try  using  the  manual  recognized  that  some  redundancy  is  desired.  Masking  it 

itself  to  determine  whether  information  on  maintainable  only  defeats  the  intent  and  adds  to  the  cost.  Figure  4-2 

units  is  scattered  throughout  the  manual  or  consolidated  illustrates  a case  where  two  versions  of  a schematic  were 

in  one  location.  If  a " refer  to”  problem  exists,  it  can  be  prepared.  From  the  viewpoints  of  both  cost  and  user 

eliminated,  to  a large  extent,  by  consolidating  all  benefit,  redundant  presentations  are  preferred. 


References  to  Manual  Pages  Containing 

Ramp  Generator  Information 

Page  Reference 

Topic 

1-5  through  1-7 

Composition  in  terms  of  transistors 
and  diodes 

4-12  through  4-14 

Narrative  description,  viz..  Operating 

Principles 

5-31 

Troubleshooting  chart 

5-65  through  5-76 

Pictorials,  block  diagrams,  trouble- 
shooting steps  and  schematics 

63 

Requirements  following  repair 

6-1 1 through  6-15 

Calibration  procedures 

Figure  4-1 . Illustration  of  Dispersion  Throughout  Manual. 
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Test  5a.  Package  Content  and  Sequence  — Organization  Material 


>1  andardization  is  an  effective  technique  for 
enhancing  readability  and  comprehension.  Where  main- 
tenance  niaiuials  are  concerned,  standardization  means 
(hi’  -ame  content,  format,  and  sequence  of  information 
within  a package.  To  be  acceptable,  the  materials  within 
each  package  should  include  items  listed  below  in  the 
order  in  which  they  art-  listed. 


I able  of  Contents 
Terminology  Picture 
Topdown  Breakdown 

| Organizational  Material 

Operating  Description 
Troubleshooting 

Kcpair  Procedui.  - 

\ 

| Technical  Mau.ul 

lest  5a,  discussed  below,  treats  the  first  three  items 
referred  to  as  organizational  material.  The  last  three 
items,  referred  to  as  technical  material,  arc  discussed  in 
Test  5li. 

(a)  Tahir  ■>)  Contents.  A minor  access  problem 
remains  even  when  all  relevant  material  is  consolidated 
in  one  package.  Use  a “local”  table  of  contents  to 
alleviate  this  problem.  An  acceptable  local  table  of 
contents  is  presented  in  Figure  5-1.  Alternatively,  an 
overview  or  data  coverage  plan  similar  to  that  shown  in 
Figure  1-3  can  he  used.  This  latter  option  is  especially 
appropriate  when  predominantly  narrative  material  is 
presented  under  separate  cover  from  procedurally- 
oriented  material. 


A local  table  of  contents  is  needed  to  show  what 
content  material  is  available  rather  than  to  direct  the 
user  to  a /sage.  This  is  particularly  important  for 
microform  presentations  where  page  scanning  is  not 
practical. 

(b)  Terminology  Picture.  Poor  or  lazy  readers  tend 
to  skip  over  unfamiliar  technical  terminology.  To 
alleviate  this  problem,  provide  one  or  more  pictorials  to 
introduce  (he  reader  to  main  features  of  the  maintain 
able  unit.  Of  ours*-,  tin-  pictorial  cannot  eliminate  all 
reading  , m>  caused  h)  terminology  (e.g.,  pulsing, 
gating,  coupled  to,  nonlinearity,  etc.),  hill  at  least  the 
reader  will  have  seen  the  names  of  the  equipment  item 
he  w ill  he  reading  about  This  content  item  also  aid.-  in 
locating  and  recognizing  the  items  during  iii'.intcnance. 
A sample  terminology  pictorial  is  shown  m Figure  5-2. 
Note  the  “contextual”  locator  picture  with  the 
accompanying  blowup,  and  cutaway. 

(c)  Topdown  breakdown.  Portions  of  the  topdown 
breakdown  mav  he  included  in  packages  for  larger 
maintainable  units.  Presented  diagrammaticallv  in 
Figure  5-3,  this  content  item  helps  the  technician 
“visualize'  the  troubleshooting  progression  and  the 
actions  required  to  correct  the  malfunction.  The 
topdown  breakdown  also  provides  a diagrammatic 
version  of  the  items  to  he  described  and  establishes  the 
referents  for  the  maintenance  information  of  the  / tackage . 
As  shown  in  F'igure  5-3,  the  topdown  breakdown  should 
include  enough  of  the  upper  hierarchies  to  help  “locate” 
the  item  being  discussed  in  the  package. 


Azimuth  Mark  Generator 


Terminology  Pictorial 

Topdown  Breakdown 

Operating  Description 

Function 

Two-Stage  Amplifier 

Emitter  Follower 

Trouble  Analysis  Aids 

Verification  of  Malfunction 

Power  Checks 

Piece  Part  Isolation  Checks 

References 

Repair 

Adjust/Alignment 

Standard  Operating  Procedures  (SOP) 


UNIT  3 
SONAR 

TRANSMITTER 


Next  Higher  Echelon 


Maintainable 
Unit  to  be  - 
Discussed 


3A5A4 

FM  TRANSMITTER  DRIVER 
SAME  AS  3A5A3 


Figure  5-3.  Sample  of  Topdown  Breakdown. 
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Test  5b.  Package  Content  and  Sequence  — Technical  Material 


This  test  is  a continuation  of  Test  5a  which  states 
that  an  acceptable  package  of  materials  should  contain 
the  items  listed  below  in  the  order  they  are  listed. 

Table  of  Contents  1 . 

Terminology  Picture  / Organizational  Material 

Topdown  Breakdown  ' 

Operating  Description  ) 

Troubleshooting  > Technical  Material 

Repair  Procedures  J 

The  technical  material  items  are  accounted  for  in  this 
test. 

(a)  Operating  Description.  This  content  item  may  be 
required  as  part  of  the  maintainable  unit  package  or  it 
may  be  provided  under  separate  cover.  In  either  case, 
care  should  be  taken  to  present  only  relevant  informa- 
tion, and  then  in  the  most  comprehensible  format.  These 
matters  are  considered  in  detail  in  the  communication 
tests. 

(b)  Troubleshooting.  Troubleshooting  aids  are 
required.  They  may  appear  as  schematics,  block 
diagrams,  lunctiona!  flow  diagrams,  or  proceduralized 
sequences.  The  proceduralized  aids  may  appear  in 


tabular,  step  x step,  or  logic  tree  format.  These  aids 
should  appear  immediately  after  Operating  Descriptions 
since  the  latter  arc  intended  to  provide  background 
material  necessary  or  desirable  in  trouble  analysis.  The 
troubleshooting  aids  themselves  may  warrant  some 
sequencing  or  grouping  as  shown  in  Figure  5-1 , Table  of 
Contents  for  a Sample  Maintainable  Unit.  Here,  the  aids 
are  grouped  according  to  a logical  approach;  namely, 
verily  that  the  unit  is  faulty;  check  power  supply  and 
distribution;  and,  finally,  isolate  the  faulty  piece  part. 
Again,  this  arrangement  is  appropriate  for  microform 
presentations  where  it  is  important  to  show  the  user 
what  is  available  — three  specific  types  of  trouble- 
shooting aids  rather  than  merely  “troubleshooting.” 

(c)  Re/sair  Procedures.  The  final  content  item  in  the 
maintainable  unit  package  describes  all  procedures 
except  troubleshooting.  The  procedures  may  include 
servicing,  checks  and  inspections,  and  corrective  actions 
such  as  replace,  repair,  or  calibrate.  Where  warranted, 
the  reader  may  be  referred  to  other  parts  of  the  manual 
lor  standard  operating  procedures  which  apply  to  the 
maintainable  unit.  This  section  may  also  be  used  to  show 
actions  that  are  “not  required,”  e.g.,  alignment/adjust- 
ment  of  this  PCC  is  not  required  following  replacement 
of  parts. 


TECHNICAL  COMMUNICATION  REQUIREMENTS 
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; 
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Rationale 

The  purpose  ol  maintenance  manuals  is  to  communi- 
cate technical  information  in  order  to  enhance  the 
performance  capability  of  maintenance  technicians. 
Manuals  accomplish  this  by  describing  the  equipment  to 
be  maintained  and  the  procedures  involved  in  perform- 
ing the  maintenance.  These  communications  are  often 
inadequate  because  of  information  "overload.’'  This 
problem  occurs  when  the  writer  includes  more  informa- 
tion than  the  technician  needs  to  perform  the  main- 
tenance action.  In  other  cases,  overload  occurs  when  too 
much  information  is  included  in  a given  image  area 
resulting  in  a cluttered  appearance.  The  tests  to  follow 
will  discuss  both  the  excess  and  clutter  inadequacies. 

Communication  problems  also  occur  when  presenta- 
tions include  the  wrong  type  of  information.  These 
inadequacies  can  result  from  misplacing  emphasis  on 
graphic  or  prose  materials,  e.g.,  not  including  enough 
pictorials.  \ second  communication  problem  with  type 
of  information  concerns  the  tradeoff  between: 
(I)  telling  the  technician  what  to  do  and  (2)  letting  him 
figure  out  the  best  procedure  based  on  a description  of 
the  equipment  at  hand.  Too  much  emphasis  on  either  of 


these  approaches  results  in  communications  considered 
inadequate  by  some  technicians. 

Requirements 

The  technical  communication  adequacy  of  manuals 
will  be  enhanced  when  the  following  requirements  are 
emphasized: 

• Presentations  should  include  only  that  informa- 
tion required  to  support  job  performance. 

• The  amount  of  information  included  in  the 
image  area  should  be  controlled  to  prevent 
clutter. 

• The  balance  between  narrative  and  pictorial 
should  favor  pictorials  to  minimize  procedural 
errors  and  performance  time. 

• Troubleshooting  materials  should  include  a mix 
of  descriptive  and  procedural  information. 

These  tests  apply  to  all  system  description  and 
procedural  materials.  Collect  these  materials  and 
evaluate  their  communication  adequacy  according  to  the 
following  tests. 
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Test  6.  J ob  Relevance  Check 


Presentations  which  combine  irrelevant  and  relevant 
information  arc  considered  difficult.  This  condition 
occurs  most  often  in  schematics  and  pictorials  which 
include  more  detail  than  the  technicians  need.  Review 
the  materials  in  your  maintenance  packages  for  job 
relevance.  Information  which  is  not  relevant  to  the  job 
at  hand  should  be  eliminated. 

Figure  0-1  illustrates  excess  detail  in  schematics.  The 
piece  parts  of  this  schematic  are  a faithful  representation 
of  system  composition  and  operation.  However,  this 
schematic  was  included  in  an  organizational  level  main- 


tenance manual  where  replacement  of  piece  parts  was 
not  authorized.  Thus,  the  detail  might  be  meaningful  to 
the  more  sophisticated  technicians,  hut  the  majority  of 
technicians  find  it  difficult  to  interpret.  Figure  6-2 
shows  the  result  of  eliminating  excess  detail  from  a 
similar  schematic.  This  block  diagram  is  much  easier  to 
use  than  its  Figure  6-1  counterpart. 

Figure  6-3  illustrates  excess  and  appropriate  amounts 
of  detail  in  a line  drawing,  considering  that  the  job  at 
hand  is  the  removal  of  the  pin  and  hinge  of  the 
mechanical  assembly. 


Figure  6-1 . Sample  (partial)  of  F.xcessive  Detail  in  Schematic: 
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Test  7.  Materials  Compression  Review 


Information  compression  is  different  from  excess 
detail  in  that  information  compression  occurs  when  too 
much  relevant  information  is  placed  in  a given  image 
area. 

Information  compression  in  schematics  is  illustrated 
in  Figure  7-1.  Dispersion  of  the  information  is  the  only 
solution,  but  doing  this  may  require  more  pages,  thereby 
creating  problems  of  page  flipping.  As  yet,  there  is  no 
good  compromise  between  page  flipping  and  compres- 
sion. However,  a reasonable  rule  of  thumb  is  as  follows: 
"Where  multiple  pages  already  exist,  disperse.  Where 
compression  exists  on  a single  page  (no  foldouts),  do  not 
disperse . ” There  are  no  verified  standards  to  guide  you 
in  determining  whether  a schematic  is  compressed. 


However,  Figures  7-2  and  7-3  illustrate  acceptable  and 
cluttered  schematics.  The  acceptable  version  contains 
about  20  elements  per  2.5-  x 2.5-inch  area,  or  about 
three  elements  per  square  inch.  The  cluttered  version 
contains  approximately  30  elements  in  the  same  area,  or 
almost  five  elements  per  square  inch. 

Pictorials  may  also  suffer  from  information 
compression.  Figures  7-4  and  7-5  are  examples  of  accept- 
able and  compressed  versions  of  pictorials.  For  an 
acceptable  pictorial,  the  smallest  important  dimension  of 
the  drawing  should  be  at  least  1/10  of  an  inch.  Note  also 
the  sequence  of  contextual,  enlargement,  and  exploded 
views  to  show  all  of  the  equipment  and  yet  emphasize 
the  critical  dimensions. 
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Figure  7-1.  Illustration  of  Information  Compression. 


figure  7-2.  Acceptable  Information  Compression 
(Approximately  3 elements  per  I -aj  inch) 


Figure  7-3.  Excessive  Information  Compression 
(Approximately  5 elements  per  f>  sq  inch). 

Note:  The  alpha  numeric  characters  of 

Figure  7-3  are  obviously  too  small. 

However,  use  of  larger  type  size 
would  merely  compound  the  com- 
pression problem  reducing  even 
further  the  space  available  for 
electronic  symbols. 


Figure  7-5.  Illustration  of  Information  Compression  in  a Mechanical  Situation 


Test  8.  Kquipment  Description  Review 


F.quipmcnt  descriptions  occur  under  u variety  of 
titles,  e.g.,  functional  descriptions,  theory  of  operation, 
and  principles  of  operation.  Kegardless  of  the  title,  the 
treatment  usually  includes  narrative  material 
accompanied  hy  functional  or  schematic  diagrams.  These 
materials  are  considered  one  of  the  more  complex 
manual  topics.  Rquipment  descriptions  frequently  suffer 
from  information  compression.  However,  the  symptoms 
and  cures  arc  different  from  those  discussed  earlier. 

In  printed  prose,  the  presentation  is  organized  hy 
paragraph.  Paragraph  formats  tend  to  hurv  or  “embed” 
important  points,  creating  comprehension  problems  for 
users,  especially  poor  readers.  For  example,  glance  at 
Figure  8-1  and  try  to  determine  the  number  of  points 
treated.  It  is  difficult  to  do.  Before  suggesting  solutions 
for  this  problem,  consider  a related  type  of  complexity. 
The  paragraphs  of  Figure  8-1  obviously  relate  to  the 
accompanying  schematic.  However,  the  relatively  large 


amount  of  schematic  information  causes  the  user  to 
search  lor  the  portions  being  discussed. 

The  suggested  .solution  is  to  “itemize”  both  the 
narrative  and  diapammatie  portions  of  the  equipment 
description.  A sample  lormat  lor  this  itemization  is 
shown  in  Figure  8-2.  Only  minor  wording  changes  were 
made  to  tin-  original  text  but  the  points  are  "spread  out” 
to  heighten  visibility  . Nothing  is  changed  in  the  diagram 
except  that  the  relevant  information  has  been  high- 
lighted and  placed  closer  to  its  descriptive  prose 
material.  The  effect  is  to  eliminate  much  of  the  search 
effort  involved  in  finding  the  narrative  points  and 
relating  them  to  the  relevant  portions  ol  the  diagram. 
Figure  8-2  illustrates  itemization  applied  to  a mechanical 
system.  Variations  of  this  format  arc  acceptable  as  long 
as  the  notion  of  itemizing  points  is  retained  along  with 
the  proximity  of  the  narrative  and  diagram  portions  ol 
the  presentation. 
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(2)  SHORT  RAMP  - Q101,  C101.  CR101,  R101,  R102,  R103,  R104,  and  R105 
make  up  a constant  current  source.  Q101  pumps  a constant  value  of  current  into 
charging  capacitor  C101,  regardless  of  the  voltage  across  C101.  The  voltage 
across  R104,  divided  by  its  resistance,  determines  the  amount  of  current  being 
pumped  into  C101.  Potentiometer  R102  sets  up  the  voltage  to  be  applied  across 
R104  and  is,  therefore,  used  to  set  the  length  of  the  ramp  at  approximately  17  0 
microseconds.  Switch  Q104  shorts  across  C101  when  the  ramp  has  reached  its 
prescribed  length. 

Q109  and  Q110  and  the  associated  circuitry  comprise  a flip-flop  which  is  used 
to  start  both  the  long  and  short  ramp  circuits  upon  receipt  of  a radar  trigger. 
Initially,  Q109  is  on  and  Q110  is  off.  Q110  being  off,  places  a negative  potential 
on  the  base  of  Q104,  the  short  ramp  switch,  causing  Q104  to  conduct,  shorting 
out  charging  capacitor  C101.  R121,  R122  and  CR105  form  a limiting  circuit  which 

limits  the  amplitude  of  the  incoming  radar  trigger  to  5v.  The  radar  trigger  is 
coupled  to  the  ba  c of  Q109  then  C108  and  CR106,  turning  Q109  off  and  Q110  on. 
When  Q110  comes  on,  one  side  of  R107  and  C102  are  grounded  causing  Q104  to 
turn  off.  When  Q104  turns  off,  charging  capacitor  C101  starts  charging.  Q102, 
Q103,  and  Q105  make  up  a gain-of-two  amplifier 

The  amplified  ramp  signal  is  coupled  through  CR103  to  the  base  of  Q106. 

Q106  and  Q107  form  a differential  comparator  circuit  that  is  used  to  compare 
the  short  ramp  voltage  to  a preset  voltage.  When  the  two  voltages  are  equal,  the 
comparator  output  causes  the  input  flip-flop  to  reset,  preparing  the  circuit  for  the 
next  radar  trigger. 

Initially,  Q106  is  on  and  Q107  is  off.  When  the  ramp  voltage  being  applied  to 
the  anode  of  CR103  equals  the  voltage  on  the  anode  of  CR104,  Q106  turns  off  and 
Q107  turns  on,  causing  Q108  to  turn  on.  When  Q108  turns  on,  it  resets  the  input 
flip-flop,  thus  preparing  the  circuit  for  the  next  radar  trigger.  The  short  ramp 
output  is  taken  from  the  junction  of  R114,  R115,  and  CR103  and  fed  out  at  pin  A. 


Figure  8-1 . (Sheet  1 of  2).  Partial  Narrative  of  F.quipment  Description  Illustrating  ( '.ompression  Problem. 


Figure*  8-1.  (Sheet  2 of  2).  Schematic  Portion  of  Equipment  Description  Illustrating  (Compression  Problems. 


CONTROL  COLUMNS 

1.  The  pilot's  and  copilot's  control  columns  (1)  are  pivoted  at  the 


figure  8-3.  Example  of  "Itemized”  Description  (Mechanical) 


Test  9.  Narrative-Pictorial  Balance  Check 


Procedural  presentations  often  minimize  the 
importance  of  pictorial  information.  Those  sections  of 
the  manual  which  present  maintenance  procedures 
should  he  reviewed  for  narrative-pictorial  balance.  Each 
step  in  the  procedure  should  be  assessed  with  respect  to 
the  need  for  one  or  more  pictorials  to  reduce  the 
possibility  of  error.  Error  potential  exists  whenever  a 
narrative  step  contains  reference  to: 

1 . A particular  equipment  location. 

2.  The  relationships  between  two  or  more  equip- 
ment items. 

3.  A specific  equipment  manipulation  (e.g.,  valve 
rotation). 

4.  A test  readout  which  is  continuous  (e.g.,  wave- 
form) rather  than  discrete  (e.g.,  numerical  value). 


To  he  of  maximum  value,  pictorial  information 
should  show  “contextual”  information  (background  or 
general  location)  followed  by  relative  positions  of  key 
parts  and  detailed  features  of  the  items  to  be  dealt  with 
in  a particular  set  of  instructions. 

Figure  9-1  shows  a procedural  description  containing 
no  pictorial  information.  This  presentation  requires  that 
the  user  knows  where  to  look  for  the  involved  equip- 
ment and  how  to  recognize  them,  an  unwarranted 
assumption  for  most  of  the  technician  population. 
Figure  9-2  shows  how  pictorials  can  be  added  to 
overcome  this  problem.  The  presentation  shows  a proper 
balance  between  pros*;  and  pictorial  with  the  latter 
including  a preferred  progression  from  “contextual”  to 
“enlargement  ” to  an  “ exploded  view.  ” 


5-38.  C-801 4/AWE- 1 PROGRAMMER  CONTROL-  [ 

LER  REMOVAL  AND  INSTALLATION.  (A-7B 
Airplanes  and  A-7A  Airplanes  after  A-7 
Airframe  Change  No.  2.) 

5-39*  Removal. 

a.  Remove  roller  map  display  indi- 
cator (NAVAIR  01-45AAA-2-24). 

a-1.  Reaching  behind  controller, 
remove  clamp  and  string  ties  from  con- 
troller pigtail. 

b.  Disconnect  pigtail  electrical 
connector  from  mounted  receptacle. 

c.  Remove  three  screws  securing 
controller.  One  screw  and  washer 
located  under  bottom  edge  of  auxiliary 
panel  and  two  screws  located  at  top  edge 
of  controller. 

d.  Remove  controller  from  panel. 
5-40.  Installation. 

a.  Insert  controller  into  auxiliary 
armament  panel  and  secure  with  two 
screws  at  top  of  controller  and  one 
screw  and  washer  at  bottom  of  auxiliary 
panel. 

Note 

Replacement  control  panel  may  con- 
tain 28-volt  edge -lighting  panel 
lamps.  If  28-volt  lamps  are  in- 
stalled in  control  panel,  remove 
lamps  and  replace  with  6 -volt 
lamps  (MS25237-327). 

b.  Connect  controller  pigtail  to 
electrical  receptacle  and  secure  with 
clamp  and  string  ties. 

Figure  9-1 . Illustration  of  Imbalance  in  Favor  of  Prose. 


Figure  9-2.  Proper  Balance  Between  Prot-e  and  (Iraphies. 


Test  10.  Troubleshooting  Procedures  Need 


; 


The  intent  of  schematics,  wiring  diagrams,  and 
functional  diagrams  is  to  support  troubleshooting  per- 
formance. However,  rather  than  telling  the  technicians 
what  to  do,  these  materials  represent  the  system 
hardware  in  a way  designed  to  allow  the  user  to  devise 
his  own  procedures.  Thus,  these  types  of  trouble- 
shooting aids  are  “reference”  rather  than  “guideline” 
materials.  Such  reference-type  presentations  are  often 
inadequate  for  technicians  with  little  job  experience. 
Therefore,  a very  important  rewrite  decision  is  whether 
to  augment  troubleshooting  reference  aids  with  guideline 
material. 


Complexity  — Is  the  equipment  so  complicated  by 
feedback  loops,  dependencies,  and  contingencies 
that  simple  “input-output”  logic  cannot  be  used  for 
troubleshooting? 

Frequency  — Is  the  activity  performed  infrequently? 

Time  — Is  it  important  to  minimize  time  when 
performing  the  activity? 

Procedures  are  warranted  when  the  answers  to  the  above 
questions  tend  to  be  Yes . 
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Safety  — Could  damage  to  either  personnel  or  equip- 
ment occur  as  a result  of  poor  task  performance? 


This  decision  is  not  simple.  Each  of  the  following 
factors  must  be  considered: 


Procedural  support  can  lake  many  forms  from 
specific  “step  x step”  statements  (see  Figure  1 0-1)  to 
brief  symptom-cause  charts  (see  Figure  10-2).  Because 
they  are  amenable  to  conventional  size,  both  these 
presentations  formats  are  compatible,  with  microform- 
based  systems.  A "logic  tree,”  illustrated  in  Figure  10-3, 
is  also  appropriate  lor  helping  inexperienced  technicians 
to  interpret  schematics,  but  this  format  is  not 
recommended  lor  microform-based  systems. 

.No  matter  which  of  these  three  forms  of  procedural 
support  you  select,  you  should  avoid  a completely 
directive  approach,  viz.,  tell  only  what  to  do,  not  why. 
Adding  “why”  information  (illustrated  in  brackets  in 
Figure  10-3)  eliminates  the  pure  regimentation  criticized 
by  so  many  technicians. 

The  usefulness  of  wiring  diagrams  can  frequently  be 
improved  by  adding  guideline  information.  Figure  10-4 
illustrates  a typical  wiring  diagram  which  is  supposed  to 
aid  the  technician  in  identifying  connected  terminal 
points,  a tedious  job  even  under  ideal  workspace  and 
illumination  conditions.  An  effective  relief  for  this 
problem  is  the  type  of  table  illustrated  in  Figure  10-5. 
Geographic  coordinates  (e.g.,  A-2,  C-6)  may  be  included 
to  assist  the  technician  in  tracing  the  wiring  path  on  the 
original  diagram. 


CAMERA  TROUBLESHOOTING 


Shutter  Will  Not  Open,  UV  Lamp  (Blue  Light)  Flash  Normal 


1.  Set  meter  mode  switch  (4)  to  -DC  and  meter  range  switch  (5) 
to  2.5V.  Connect  meter  probe  (2)  to  point  (7).  Meter  (6) 
should  indicate  greater  than  0 5. 


3.  Disconnect  meter  black  test  lead  (3)  from  point  (10)  and  set 
meter  range  switch  (5)  to  R x 10,000. 

4.  Clip  black  test  lead  (3)  to  the  tip  of  the  red  test  lead  (2). 
Adjust  multimeter  ZERO  OHMS  control  (1)  until  meter 
needle  indicates  0,  on  right  of  scale. 

5.  Connect  meter  black  test  lead  to  point  (10).  Connect  meter 
probe  to  point  (7).  Meter  (6)  should  indicate  less  than  1.8  on 
top  scale. 


2.  If  meter  (6)  indicates  less  than  0.5,  replace  resistor  R12  (9).  6.  If  meter  (6)  indicates  less  than  1.8,  replace  transistor  Q12 

If  meter  (6)  indicates  greater  than  0.5,  disconnect  camera  (11).  If  meter  (6)  indicates  greater  than  1.8,  replace 

power  plug  from  wall  receptacle.  resistor  R16  (8). 


SYMPTOM 

PROBABLE  CAUSE 

CHECK 

Generator  field 

Both  sides  of  one 

Lift  the  brushes  from  the 

cannot  be  flashed 

phase  of  rectifier 

generator  slip  rings  and 

(cont'd). 

CR1  shorted. 

measure  forward  and  re- 
verse resistance  of  recti- 
fier CR1  as  explained  in 
Para.  4-5-1. 

Generator  voltage 
drops  to  zero  when 
flashing  power  is 
removed  (after 
holding  switch  SI 

Open  lead  in  exciter. 

Check  connections  to 
transformer  T1,T2,T3, 
inductors  LI,  L2,  L3  and 
rectifier  CR1. 

in  "FLASH"  posi- 

One  or  more  legs  of 

Disconnect  all  connec- 

tion  for  serveral 

rectifier  in  CR1 

tions  to  rectifier  CR1  by 

seconds). 

or 

Low  generator 
voltage  with  little 
or  no  control  in 
"MANUAL". 

shorted. 

removing  a-c  leads  from 
bus  bars  on  top  of  the 
generator  and  by  lifting 
the  brushes.  Test  the 
rectifier  CR1  as  explain- 
ed in  Para.  4-5-1. 

High  generator 

Open  lead  in  exciter 

Checkfor  "open"  inwir- 

voltage  in  "MAN- 

control  winding  cir- 

ing  and  in  all  compon- 

UAL"  and  manual 
control  rheostat 

R1  4 has  little  or 
no  control. 

cuit. 

ents  of  control  winding 
circuit  (T1,T2,T3,R14. 
CR7.R11  A,  B,  C,  SI). 

Operation  is  nor- 

Open  lead  in  switch  SI 

Check  for  "open"  in  wir- 

mal  in  "MANUAL" 

or  in  regulator  second 

ing  and  in  all  compon- 

but  general  voltage 
is  high  in  "AUTO- 
MATIC" and  voltage 
adjusting  rheostat 

R4  has  little  or  no 
control. 

stage  amplifier. 

ents  of  control  winding 
circuit  (SI,  RIO,  CR5, 
L5.T5). 

Figure  10-2.  Illustration  of  Symptom  - Cause  Format 
for  Troubleshooting  Guidance  Aids. 
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igure  iU-o.  Illustration  ol  ‘ Logic  Tree  Format  for  Troubled 
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DENOTES  TERMINATION  OF  SHIELD 
AND  IS  PREFIXED  BY  THE  DESIG- 
NATION OF  THE  TERMINAL  TO  WHICH 
THE  SHIELDED  WIRE  CONNECTS. 

DENOTES  TERMINATION  OF  A SHIELD 
COMMONED  WITH  A SECOND  SHIELD 
BY  A SINGLE  TERMINATION. 


MS  DENOTES  MECHANICAL  STRAP 
SS  DENOTES  SHIELDED  SINGLE 
SP  DENOTES  SHIELDED  PAIR 
ST  DENOTES  SHIELDED  TRIPLE 
* DENOTES  LOWER  CASE  LETTER 


Figure  10-5.  Sample  Guidance  Format  to  Support  Wiring  Diagrams 


READABILITY  REQUIREMENTS 


Rationale 

Certain  writing  techniques  are  capable  of  improv- 
ing readership  (the  inclination  of  users  to  read  a 
manuscript);  readability  (how  quickly  and  easily 
material  can  be  read);  and  comprehensibility  (the 
percentage  ol  readers  who  grasp  key  points  of  the 
passage).  For  these  reasons,  your  manuscripts  should 
reflect  the  use  of  these  writing  techniques.  The 
readability  improvements  apply  only  to  the  con- 
tinuous discourse  parts  of  your  draft  manuscript  (viz., 
material  that  is  predominantly  prose,  in  paragraph 
format).  Therefore,  it  will  be  necessary  for  you  to 
select  this  type  of  passage  from  your  draft,  apply  the 
readability  tests,  and  rewrite  where  indicated. 


Requirements 

I he  following  general  requirements  aim  at  a 
'Jth  grade  level  of  readabilitv  : 

• Paragraph  headings  should  be  used  to  facilitate 
access  and  to  identify  the  type  of  material  which 
will  follow. 

• Paragraphs  should  be  limited  to  one,  two,  or 
three  topic  sentences. 

• Words  per  paragraph  and  words  per  sentence 
should  be  limited  to  minimize  structural  ties  re- 
quired of  the  user. 

• Long  and  unfamiliar  words  should  be  avoided. 

• Pictorials  should  be  used  to  introduce  key  equip- 
ment terminology  used  in  prose  discussions. 

• Layout  should  enhance  reading  speed  and 
comprehension. 
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Test  1 1 . Headings  Review 


Paragraph  headings  serve  two  purposes.  First,  they 
ease  access  hv  permitting  the  reader  to  scan  a |>agc  to 
find  material  he  wants.  Second,  they  alert  the  reader  to 
the  type  of  information  contained  in  the  paragraph, 
thereby  enhancing  readability.  Obviously,  all  major 
paragraphs  require  headings,  hut  no  standards  exist  to 
determine  how  many  of  your  subparagraphs  must  have 
lead-ins  or  headings.  A standard  of  50%  is  suggested. 
Add  headings  of  about  three  or  four  words  where  less 
than  half  of  your  subparagraphs  have  lead-ins. 

Reading  tends  to  be  easier  and  more  efficient  when 
the  text  covers  what  the  reader  expected  it  to  cover. 
Chapter  and  paragraph  headings  are  important  clues  a 
reader  uses  to  build  his  expectancies.  Therefore,  all 
material  within  a / mragraph  should  be  consistent  with  its 
paragraph  heading.  Figure  II  I is  a sample  TVI  manual 
passage  which  violates  this  rule.  The  encircled  informa- 
tion in  the  figure  is  a description  of  equipment  composi- 
tion while  the  paragraph  heading  alerts  the  reader  to  a 
discussion  of  manual  purpose. 


Lack  of  topic  consistency  between  /mragraphs  and 
overview  materud  is  more  difficult  to  spot  and  more 
disruptive  to  the  reader.  Figure  11-2  illustrates  such  a 
consistency  error.  The  enclosed  excerpt  shows  sub- 
paragraphs  (b)  and  (c)  of  paragraph  4-1 . The  titles  at  the 
lop  show  all  topics  discussed  under  paragraph  4-1.  The 
continuity  error  is  that  subparagraph  (b)  and  F igure  4-1 
lead  the  reader  to  expect  that  four  basic  functions  of  the 
system  will  be  discussed  and  that  they  w ill  be  discussed 
in  the  order  shown  in  the  figure.  Contrary  to  this 
expectation,  the  last  function  is  discussed  first  [sub- 
paragraph  (c)  ] ; none  of  the  remaining  three  functions 
are  discussed  (compare  topics  at  top  of  F igure  1 1-2  w ith 
basic  functions  shown  in  F’igure4-I);  and  two  unin- 
troduced topics  are  discussed  (channel  function  and 
video  output).  This  lack  of  continuity  is  disconcerting, 
causing  the  reader  to  reread  material  he  has  already  read, 
look  elsewhere  for  the  material  he  expected  to  find,  and 
generally  lose  confidence  in  the  credibility  of  the 
manual. 


1-1,  PURPOSE  OF  MANUAL. 

This  manual  contains  instructions  for  installation,  operation,  and  mainte- 
nance of  Signal  Data  Converter  Group  AN /WSA  - 1 C.  |Thc  AN/WSA-iC  consists  of 
one  Signal  Data  Converter  CV-933  / WSA  - 1 C,  one  Cont  rol  - Indicator  C-  3247/WSA-l , 
and  three  Control -Indicators  C- 3248 /WSA - 1 , j 


1-2.  DESCRIPTION  OF  SIGNAL  DATA  CONVERTER  G ROUP  AN /WSA - 1C. 

The  AN /WSA-  1C  accepts  range  and  azimuth  data  in  three  channels  from 
computing  or  tracking  devices  and  generates  distinctive  video  symbols  to  present 
the  computed  or  tracked  position  of  the  three  targets  superimposed  upon  a PPI 
display. of  search  radar  output.  The  AN/WSA-IC  is  shown  in  figure  i-1. 


Figure  11-1.  Illustration  of  Text  Placed  in  Wrong  Paragraph. 
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4 — 1 Overall  Functional  Description 

a.  General 

b.  Basic  Process  (e.g.,  Conversion,  Synchronization,  Pulse  Generation,  Symbol  Forming) 

c.  Symbol  Forming 

d.  Channel  Function 

e.  Video  Output 


b.  THE  BASIC  PROCESS.  - The  AN/WSA-1C  processes  the  range  and  azimuth 
input  data  in  three  separate  channels.  The  process  performed  consists  of  four 
basic  steps  as  shown  in  figure  4-1.  The  first  step  is  conversion  of  the  data  to  a 
form  usable  for  synchronization  with  the  range  and  azimuth  sweeps  of  the  indi- 
cator. The  second  step  is  synchronization  of  the  data  with  the  range  and  azimuth 
sweeps  of  the  indicator.  The  third  step  is  generation  of  pulses  so  synchronized 
that  they  will  form  the  range  and  azimuth  components  of  the  video  symbols.  The 
fourth  step  is  selective  gating  and  mixing  of  the  pulses  in  the  three  channels  to 
produce  three  distinctive  symbols. 


c.  SYMBOL  FORMATION.  - The  sym- 
bols generated  are  a box,  a cross,  and 
the  letter  H as  shown  in  figure  4-2.  In 
order  to  generate  these  symbols,  the 
range  and  azimuth  pulses  shown  in  figure 
4 - 3 are  generated,  selectively  gated,  and 
mixed  to  form  symbol  video. 

(1)  SIMPLIFIED  SYMBOL  FORMATION. 
The  symbols  are  actually  formed  by 
segments  of  the  range  sweep  as  shown  in 
figure  4-4.  The  upright  or  radial  sides 

of  the  symbols  are  relatively  long  (10-1/2 
percent  of  the  range  of  the  symbol).  The 
circumferential  lines  in  the  symbols  are 
composed  of  segments  of  the  range  sweep 
which  are  relatively  very  short. 

(2)  DEFINITION  OF  TERMS.  - The 
following  are  definitions  of  terms  pecu- 
liar to  symbol  formation  in  the  AN/WSA-1C. 


input  Range  4 

AZIMUTH  DATA 


Figure  4- 1.  Signal  Data  Conversion, 
Basic  Block  Diagram 


Figure  1 1-2.  Illustration  of  Topical  Discontinuity. 
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Test  12.  Topic  Sentence  Check 


I 


; 


rxtch  paragraph  of  your  prose  material  should  cover 
one,  two,  or  possibly  three  main  points.  To  check  your 
work  against  this  standard,  read  each  paragraph  and 
underline  topic  sentences  or  key  points.  Consider  break- 
ing paragraphs  with  three  or  tour  main  points  into  two 
paragraphs. 

If  a paragraph  has  many  key  points,  say  six  or  seven, 
consider  an  alternative  tabular  presentation.  Figure  12-1 
shows  an  “all  prose,  paragraph”  presentation  which 
treats  seven  key  points.  Restructuring  into  seven  short 
paragraphs  is  a marginal  solution.  Figure  12-2  shows  a 
more  concise  and  readable  tabular  version  of  the  same 
seven  points  edited  to  eliminate  the  excess  verbiage.  The 
original  version  contains  26  lines  of  text  which  buried 
main  points  in  a paragraph  format.  The  tabular  version  is 
much  shorter  and  provides  a great  deal  more  visibility  to 
each  of  the  seven  key  points.  You  will  have  to  use  your 


judgment  to  determine  whether  the  alternative  presenta- 
tion should  replace  or  augment  the  original  version. 
Using  our  26-line  sample  to  illustrate,  you  may  wish  to 
retain  the  prose  version  and  add  the  tabular  presentation 
to  summarize  and  emphasize  the  key  points. 

1 ague  or  unclear  topic  sentences  are  common  and 
very  disruptive  to  the  poor  reader.  If  you  understand  all 
words  of  a paragraph  but  have  to  ask  yourself  “what  was 
that  all  about,”  the  paragraph  has  one  or  more  vague 
topic  sentences.  The  paragraph  should  be  reviewed  in  an 
effort  to  identify  the  topic(s)  the  writer  was  attempting 
to  discuss.  Where  topics  can  be  identified,  you  must 
rewrite  emphasizing  these  points.  Where  you  find  it 
difficult  to  identify  topic  sentences,  consider  eliminating 
the  material.  Before  you  eliminate  any  material, 
however,  make  sure  the  problem  is  vague  writing  as 
opposed  to  clear  writing  on  a difficult  topic. 


I 


I 
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After  the  trouble  has  been  determined  to  beioteT'nal,  the  AN/USM-105  oscillo- 
scope should  be  used  to  compare  the  w<iyef<Tfms  given  in  the  troubleshooting 
charts,  on  the  schematic  diagvajjiJrT-''Snd  in  the  waveform  charts  with  the  wave- 
forms in  the  equipment.^^Ii'-rs'Tmportant  to  use  the  AN/USM-105  because  many 
of  the  waveform  spxe-stfnt  in  the  equipment  are  very  fast  pulses  which  will  not  be 
displayed  pxo-p'C'rly  on  an  oscilloscope  with  a bandpass  of  less  than  15  megacycles, 
Wayjiferffn  compari  sons  are  the  most  effective  method  of  servicing  this  equipment. 
|(3)ffesi  nlnnrf . mn.-i  imminent  s marie  on  transistor  circuits  have  little  valqe,  because 
of  the  low-impedance  and  cur  rent- sensitive  properties  of  transi^ie-rTiYA'When  a 
component  is  replaced  on  a printed  circuit  card  on  whicJi^arrlCSjustment  is  located, 
the  setting  of  the  adjustment  should  be  verified  bju-r«ference  to  the  alignment 


service  th^eqiTTpmenr  properly./V^The  advisability  of  applying  power  to  defective 
equipment  should  be  carefully  consw^rtdfrom  the  standpoint  of  causing  danger 
to  personnel  and  further  damage  to  the  equipment. 


procedure  in  Section  6. 


CAUTION 


BefjiF-e''replacing  components  located  on  a printed  circuit  card, 
(sjrftudy  the  instructions  for  printed  circuit  repair  given  in  Section  6. 
\Improper  repair  techniques  may  damage  or  destroy  printed 
circuit  cards. 


It  is  iniportant  when  making  waveform,  voltage,  or  resistance  measurements 
that  the  controls  on  the  equipment  and  test  equipment  be  set  as  required  for  the 
test.  Where-the  trouble  has  been  found  to  be  the  result  of  a defective  printed 
circuit  earn,  the  defective  component  or  components  should  be  located  by  a 
careful  analysis  using  the  waveform  and  voltage  data.  This  equipment  has  no 
parts  with  the  exception  of  light  bulbs  which  have  a definite  limited  life;  there, 
fore',  before  replacing  a printed  circuit  card  or  component  it  should  be  determined 
that  thoivoltages  into  the  printed  circuit  card  are  of  the  proper  value  to  insure 
that  the  component  failure  was  not  caused  by  a failure  elsewhere  in  the  equipment. 


Figure  12-1.  Sample  of  Text  Which  Buries  Important  Topics. 


REMEMBER  THESE  POINTS! 


1 . Is  it  safe  to  apply  power  ? 

2.  You  need  an  oscilloscope  with  a bandpass  greater  than  15  megacycles. 

3.  Resistance  measurements  are  ineffective  on  transistor  circuits. 

4.  Don't  take  short  cuts  in  PCC  component  replacement. 

5.  You  must  adjust  PCC  after  component  replacement. 

6.  Use  voltage  data  and  waveforms  to  troubleshoot  PCC. 

7.  Repair  cause  and  symptom? 


Rewritten  to  replace  26  lines  of  text 

Figure  12-2.  Preferred  Tabular  Format. 
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Test  13.  Words  Per  Paragraph  Count 


hong  paragraphs  arc  dilTii'uIt  to  read,  probably 
because  they  require  the  reader  to  make  and  retain  many 
structure  ties.’  Ties  are  the  connections  a reader  must 
make  between  words  and  phrases  to  derive  meaning.  To 
help  minimize  the  number  of  structural  ties  you  require 
ol  your  readers,  try  to  limit  paragraph  length  to  about 
45  to  60  u ords. 

In  cases  where  you  must  exceed  thus  limit , consider 
the  use  of  "peak  stress”  methods  to  give  visibility  to  the 


more  important  points  of  the  paragraph.  Tin-  peak  stress 
methods  most  suitable  for  maintenance  manuals  are 
underlining  key  phrases,  using  boldface  print,  or 
italicizing.  The  use  of  marginal  notes  is  also  a peak  stress 
method  hut  is  considered  too  “unusual"  and  mav 
detract  from  as  much  as  it  adds  to  readability.  An 
important  caution  about  peak  stress  is  not  to  overdo  it. 
For  example,  too  much  italicized  print  detracts  from  the 
readability  of  prose. 


lest  I 1.  Words  Per  Sentence  Count 


Fxcessive  structural  ties  also  result  from  too  many 
words  per  sentence.  Research  shows  that  your  target 
terhniaans  can  read  17  word  sentences.  Set  this  goal  for 
your  own  manuscripts.  U here  your  sentences  average 
more  than  'JO  words,  edit  for  the  follou  mg  problems. 

( oinpound  Sentences 

Compound  sentences  are  composed  of  two  or  more 
independent  clauses  joined  by  and.  hut,  or  other 
connectives.  \n  independent  clause  is  one  which  can 
'land  alone  (.heck  that  the  two  I'A( -A N couplers  an* 
installed  i.  an  independent  clause.  An  example  of  a 
compound  sentence  is  “The  transmitted  signal  is 
radiated  to  the  ground  a the  reflected  signal  is 
received  on  the  receiving  ante  na  from  which  it  is  led  to 
the  balanced  detector.”  Breaking  this  sentence  into  two 
by  using  a period  rather  than  “and”  will  increase  its 
readability. 

Complex  Sentences 

Sentences  composed  ol  one  independent  and  one  or 
more  dependent  clauses  are  complex  sentences. 

I )c pendent  clauses  cannot  stand  alone.  Here  is  an 
example  (the  dependent  clause  is  ital  ieized):  "The 
receiver-transmitter  generates  a low  frequency- 


modulated  microwave  carrier,  radiates  this  carrier  down- 
ward from  the  aircraft,  receives  the  reflected  signal  from 

tile  terrain,  and  produces 

an  audio-frequency  voltage. 

the  frequency  of  which  is 

the  difference  between  the 

instantaneous  transmitted 

and  received  signal  fre- 

quencies.”  Rewriting  to 
improve  readability. 

make  two  sentences  will 

Prepositional  Phrases 

1 n necessary  prepositional  phrases  frequently  add  to 

the  word  count.  Kxamples 
preferred  equivalents  are: 

ol  such  phrases  and  their 

along  111**  line’s  of  ...  . 

. . . like 

for  the  purpose*  of  ... 

. . . for 

tor  (he-  reason  dial  ... 

. . . since 

from  the  point  of  view  of  . . for 

in  accordance*  with  . . . 

. . b\  . under 

in  case*  of 

. . if 

hi  the  event  that  .... 

. . d 

in  the  ne'ighbetrhood  of 

. . about 

on  the*  basis  of 

. . bv 

prior  to 

. . before 

with  reference  te>  . . . . 

. . about  (or  leave  out) 

with  regard  to  

. . about  (or  leave  out) 

with  the*  result  that  . . 

. . . so  that 

Passive  to  Active 

F.quipmcut  descriptions  are  notorious  lor  their  use 
of  the  passive  rather  than  the  active  voice.  The  passive  is 
less  familiar  to  readers,  must  include  the  acting  agent  in 
an  awkward  phrase,  and  requires  an  auxiliary  verb  which 
adds  to  the  word  count. 


Poor:  The  error  signal  from  the  synchro  rotor  is 

clamped  to  a maximum  of  one  volt  by 
the  CR601  and  CR602  producing  a 
voltage  drop  across  R60 1 . 

Better:  CR601  and  CR602  clamp  the  error  signal 
from  the  synchro  rotor  to  a maximum  of 
one  volt... 


Empty  Words 

Technical  writing  often  includes  words  which  look 
meaningful  hut  are  not.  For  example,  “perform  the 
required  test”  would  be  more  helpful  if  the  name  of  the 
test  was  given  in  place  of  the  word  “required.”  If  the 
test  to  be  performed  is  obvious  from  the  previous 
statement,  the  word  “required”  is  not  needed.  Three 
other  words  which  you  can  frequently  delete  without 
damage  to  the  meaning  are:  “concerned,”  “involved,” 
and  “respectively.” 


Modifiers 

Strings  of  modifiers  are  hard  to  read  and  difficult  to 
understand.  The  sample  below  is  an  illustration  of  the 
problem. 

-V,  luriii.-lir'J  li\  ill!  manufacturer,  ill' 

\\/WS\l  l i,  compatible  with  an)  radar 
set  capable  of  furnishing  antenna  azimuth  as 
a three-wire , one-speed,  6 0-eps  or  iOO-eps 
svnchrii  i lata  milage  It  is  also  compatiblc 
vmiIi  anv  computing  or  tracking  devices 
capable  of  lurnisbmg  a/iinnlli  as  a three- 
wire,  one-speed,  6 O-eps  nr  tOOs  ps  synchro 
data  voltage  and  capable  ol  furnishing  range 
as  a three-wire,  one-speed,  60-cps  or  400-eps 
synchro  itata  voltage  calibrated  at  200  v arils 
per  degree.  The  operating  frequency  of  the 
servo  loops  mav  be  changed  by  changing 
synchros  and  motor  generators. 


Such  phrasing  is  hard  to  read  as  continuous  prose  and 
would  be  better  presented  in  the  following  format. 

Inputs:  (I)  Katldr  video 

(2)  Kadar  trigger  with  20  t 5 volts 
amplitude 

(3)  Kadar  antenna  azimuth  (3-w  ire , 

I -speed,  60-  or  400-eps  synchro 
voltage) 

(4)  Three  channels  of  target 
azimuth  data  (3- wire,  I -speed, 

60-  or  400-cpssyncro  voltage) 


Test  15.  Syllables  Per  Word  Count 


Research  has  shown  that  your  target  technicians  can 
read  text  averaging  one  and  one-half  syllables  per  word. 
Unfortunately,  manuals  deal  with  lengthy,  technical 
nomenclature,  e.g.,  attenuator,  modulator,  unblanking 
and  radial  compensation  circuit.  Since  such  words  arc 
required,  you  should  omit  them  when  testing  your  draft 
for  word  length.  To  perform  this  test,  count  syllables  per 
100-word  passages  (omitting  technical  nomenclature). 
You  should  not  have  more  than  1 50  syllables.  If  your 
drafts  exceed  this  standard,  review  your  text  for  lengthy 
words  which  might  be  replaced  by  shorter  words  or  by 
two  or  more  short  words  (dilution).* 


ascertain  find  out 

discontinue stop 

enable let,  allow 

verify  check,  test 

accordingly so 

consequently so 

for  this  reason  then 

in  addition  besides,  also 

more  specifically for  instance,  for  example 

moreover now,  next 

nevertheless but,  however 


’These  and  the  examples  for  prepositions,  conjunctions,  and  connectives  are  drawn  from  FTesch.  R.  How  to  write,  speak  and  think 
more  effectively.  New  York:  New  American  Library,  1946. 
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Test  16.  Equipment  Nomenclature  Check 


4 


I 

i 


Omitting  lengthy  and  unfamiliar  nomenclature  from 
the  word  length  test  merely  avoids  a troublesome 
reading  problem.  One  way  to  address  this  problem  is  to 
introduce  technical  terminology  to  the  reader  at  the 
outset  of  the  relevant  passages.  Figure  16-1  shows  a 
pictorial  with  selected  eallouts,  the  appropriate  means 


for  introducing  new  equipment  terminology.  You  should 
cheek  your  prose  to  determine  that  all  unfamiliar 
nomenclature  is  treated  in  the  nomenclature  pictorial. 
Where  the  text  uses  an  equipment  name  that  is  not 
included  in  the  pictorial,  either  add  the  term  to  the 
pictorial  or  expand  the  text  to  define  the  new  term. 


3-23.  When  the  main  system  pressure  (hoist  or  lower)  reaches 
3050  to°°  Ps*-»  the  Piston  is  moved  against  the  force  of  the 
spring.  As  the  relief  valve  piston  moves,  porting  is  opened 
between  the  piston  and  manifold  to  allow  enough  fluid  to  flow 
past  the  piston  to  the  opposite  side  of  the  main  loop  to  main- 
tain the  pressure  setting.  When  pressure  lowers  below  the 


Figure  16-1.  Illustration  of  Rquipment  Nomenclature  Pictorial. 
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Test  17.  Layout  Review 


Layout  of  information  within  a page  area  or  frame 
influences  reading  speed,  comprehension,  and 
preference.  You  should  review  two  dominant  text 
features  to  maximize  these  benefits.  First,  a double 
column  format  is  superior  to  a single  column  format. 
This  is  illustrated  in  Figure  17-1.  Second,  related 
materials  should  be  contiguous.  This  principle  applies 
mainly  to  contiguity  between  prose  and  related  graphic 
material.  Graphics  must  be  referenced  in  the  text 
whenever  they  are  used  to  support  a conclusion  drawn  in 


the  text.  Further,  convention  requires  that  graphics 
always  follow  the  text  reference.  Guidelines  for  layout 
of  graphics  and  related  prose  are: 

1 . Arrange  prose  and  related  graphics  for  simulta- 
neous viewing. 

2.  Place  small  graphics  at  the  bottom  o(  a page. 

Figures  17-2  and  17-3  illustrate  good  and  poor  examples 
of  prose/ graphic  contiguity. 


2-142.  JETTlSOy  SYSTEM. 

2—143.  The  jettison  system  (figure  2-51  and 
table  2-1)  lias  three  jetti-on  circuits,  salvo,  select, 
and  auxiliary.  When  wing  mounted  weapons/ stores 
are  jettisoned  u?ing  cither  salvo  or  select,  every- 
thing below  the  MAC *9  ejector  rack  is  released. 
The  auxiliary  circuit  permits  the  jettisoning  of 
rocket  pods,  CBl  a,  and  bombs  loaded  on  the 
MER/TER,  retaining  the  racks  on  the  MAU-9 
ejector  rack.  Auxiliary  jettisoning  of  wing 
mounted  AIM-9  or  AGM-87A-1  missiles  fires  the 
missile  in  an  unarmed,  unguided  condition,  retain- 
ing the  launcher.  Fuselage  mounted  AIM -9  or 
AGM-87A-1  missiles  are  fired  unarmed  and 
unguided  using  the  select  jettison  circuit.  See 


figure  2-52  for  circuit  breakers  used  in  the 
system. 

2-144.  SALVO  JETT  BUTTON.  The  SALVO 
I TIT  button  (figure  2-53),  located  on  the  instru- 
ment board,  is  a momentary  contact  switch.  The 
switch  permits  jettisoning  of  everything  mounted 
on  the  MAU-9  ejector  racks. 

2-145.  SEL  JETT  BUTTON.  The  SEL  JFTT 
button  (figure  2-53),  located  on  the  instrument 
board,  is  a momentary  contact  switch.  The  switch 
permits  jettisoning  of  all  MAI  -9  mounted  weap- 
on^ stores  from  selected  wing  stations  and  the 
unarmed  and  unguided  firing  of  fuselage  mounted 
missiles. 


2-142.  JETTISON  SYSTEM. 

2—143.  The  jettison  system  (figure  2-51  and  table  2 I)  lias  three  jettison  circuits,  salvo,  select,  and 
auxiliary.  When  wing  mounted  weapons/ stores  are  jettisoned  using  either  salvo  or  select,  even  thing 
below  the  MAU-9  ejector  rack  is  released.  The  auxiliary  circuit  permits  the  jettisoning  of  rocket  po«L. 
CBU \ and  bombs  loaded  on  the  MKH/TER,  retaining  the  racks  on  the  MM  9 ejector  rack.  Auxiliary 
jettisoning  of  wing  mounted  AIM-9  or  AGM-874-1  missiles  fires  the  missile  in  an  unarmed,  unguided 
condition,  retaining  the  launcher.  Fuselage  mounted  AIM-9  or  AGM-H7A  1 missiles  are  fired  unarmed 
and  unguided  using  the  select  jettison  circuit.  See  figure  2 52  for  circuit  breakers  used  m the  system 

2-144.  SALVO  JETT  BUTTON.  The  SALVO  JETT  button  (figure  2 -53).  located  on  the  instrument 
hoard,  is  a momentary  contact  switch.  The  switch  permits  jettisoning  of  everything  mounted  on  the 
MAU-9  ejector  racks. 

2-  145.  SEE  JETT  BUTTON.  The  SF.E  JETT  button  (figure  2-  53).  located  on  the  instrument  board,  is 
a momentary  contact  switch.  The  switch  permits  jettisoning  of  all  MAI  9 mounted  w capons/' stores  from 
selected  wing  stations  and  the  unarmed  and  unguided  firing  of  fu-dage  mounted  missiles. 


Figure  17-1.  Illustration  of  Preferred  and  !,«•»  I fe.iralilr  Prrwntation*  for  Narrative. 
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Figure  17-2.  Illustration  of  Poor  Contiguity  Between  Prose  and  Pictorial  Material. 
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The  requirements  and  criteria  for  rewriting  technical  form.  These  checklists  may  be  used  to  review  and 
manuals  to  improve  readability  and  comprehensibility  rewrite  a technical  manual  once  the  reader  is  thoroughly 
have  been  presented  in  some  detail.  This  section  familiar  with  the  rationale  underlying  the  requirements 
summarizes  those  requirements  and  criteria  in  a checklist  and  the  tests  which  explain  the  use  of  the  criteria. 


| 
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ORGANIZATION  REQUIREMENTS  SUMMARY 


Manual  organization  should  be  based  on  a hierarchy  of  maintainable  units. 

— Organize  around  a family  tree  or  topdown  breakdown  of  maintainable  units. 

— Organize  for  1 to  10  ratio  of  superordinate  to  subordinate  maintainable  units. 

A repair  cycle  overview  should  be  included.  This  should  be  a diagrammatic  representation  of  the  succes- 
sion of  maintenance  actions. 

— Illustrate  the  succession  of  maintenance  actions  required  to  complete  a repair  cycle. 

— Diagrammatic  overviews  should  be  used  instead  of  or  in  support  of  any  narrative. 

— Use  several  overviews  for  larger  systems. 

All  information  concerning  a maintainable  unit  should  be  consolidated  into  a single  package. 

— Eliminate  "refer  to"  problems  by  consolidating  all  information  about  a maintainable  unit. 

The  content,  format,  and  sequence  of  information  within  a package  should  be  standardized. 

— Use  a "local"  table  of  contents  to  indicate  material  available  within  a package. 

— Provide  pictorials  to  introduce  the  reader  to  terminology  and  features  of  the  maintainable  unit. 

— Provide  a topdown  breakdown  which  establishes  the  referents  for  the  maintenance  procedures  of 
the  package. 

— Include  operating  descriptions  in  the  package  or  under  separate  cover. 

— Trouble  analysis  aids  should  immediately  follow  operating  descriptions. 

— Trouble  analysis  aids  should  be  sequenced  or  grouped  in  a logical  order. 

— Include  all  nontroubleshooting  procedures  as  the  final  content  item  in  the  maintainable  unit  package. 
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COMMUNICATION  REQUIREMENTS  SUMMARY 


Presentations  should  include  only  that  information  required  to  support  job  performance. 

Eliminate  information  which  is  not  relevant  to  the  job  at  hand. 

The  amount  of  information  included  in  an  image  area  should  be  controlled  to  prevent  clutter. 

— Limit  schematics  to  3 elements  per  square  inch  or  less. 

— Important  dimensions  of  drawings  should  be  at  least  1/10  inch. 

— Itemize  both  narrative  and  diagrammatic  portions  of  Equipment  Description  materials. 

The  balance  between  narrative  and  pictorial  should  favor  pictorial  to  minimize  procedural  errors  and  per- 
formance time.  Provide  pictorials  when  steps  refer  to: 

— A particular  equipment  location. 

— The  relationship  between  two  or  more  equipment  items. 

— A specific  equipment  manipulation  (e.g.,  valve  rotation) 

— A test  readout  which  is  continuous  (e.g.,  waveform)  rather  than  discrete  (e.g.,  numerical 
value) 

Troubleshooting  materials  should  include  a mix  of  descriptive  and  instructional  information. 

— Add  procedural  presentations  when  warranted  by  consideration  of  troubleshooting  complexity, 
frequency,  time  and  safety. 
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READABILITY  REQUIREMENTS  SUMMARY 


Paragraph  headings  should  be  used  to  facilitate  access  and  to  identify  the  type  of  material  which  will  follow. 

— 50%  of  the  subparagraphs  should  have  headings  on  leadins. 

— Headings  should  be  no  more  than  3 or  4 words. 

— All  material  within  a paragraph  should  be  consistent  with  the  paragraph  heading. 

— Paragraph  headings  should  be  consistent  with  expectancies  established  by  overviews. 

Paragraphs  should  be  limited  to  a few  topics  which  are  clearly  and  concisely  identified. 

— Each  paragraph  of  prose  material  should  be  limited  to  no  more  than  three  main  points. 

— Five  or  more  key  points  in  a paragraph  may  be  presented  better  as  a table. 

— Topic  sentences  in  a paragraph  should  be  especially  clear  and  concise. 

Words  per  paragraph  and  words  per  sentence  should  be  limited  to  reduce  demands  of  memory  and 
structural  ties  on  the  user. 

— Limit  paragraphs  to  45-60  words. 

— Limit  sentences  to  17-20  words. 

— Use  peak  stress  emphasis  where  lengthy  paragraphs  cannot  be  avoided. 

— Change  compound  sentences  to  simple  sentences. 

— Change  complex  sentences  to  simple  sentences. 

— Change  passive  voice  to  active  voice. 

— Eliminate  empty  words. 

— Eliminate  prepositional  phrases. 

— Eliminate  unnecessary  modifiers. 

Lengthy  and  unfamiliar  words  and  sentences  should  be  avoided. 

— Try  for  an  average  of  1-1/2  syllables  per  word  based  on  a count  of  at  least  100  words 
(eliminating  technical  nomenclature) 

— Eliminate  or  "dilute"  lengthy  words. 

Pictorials  should  be  used  to  introduce  key  equipment  terminology  used  in  prose  discussions. 

— Present  a nomenclature  pictorial  at  the  beginning  of  a section  (preferred),  or 

— Define  nomenclature  in  the  text  the  first  time  it  is  used  (less  preferablel 

Layout  should  enhance  reading  speed  and  comprehension. 

— Use  double  column  format  for  prose. 

— Arrange  graphics  and  related  prose  for  simultaneous  viewing. 


GENERAL  REWRITE  PRACTICES 


Rationale 

Technical  writers  employ  many  more  ''practices 
than  arc  reflected  in  the  preceding  discussions  ol 
Organization,  Technical  Communication,  and 
Readability.  While  it  would  he  impractical  to  consider  all 
practices,  some  of  the  more  important  ones  warrant 
attention,  but  two  important  constraints  must  be 
emphasized.  First,  the  general  rewrite  practices  in  this 
section  are  not  included  as  test  items  because  they  are 
not  powerful  enough  to  warrant  a rewrite  decision.  I he 
practices  should  be  applied  only  il  a decision  to  rewrite 
has  been  made  on  the  basis  of  the  Organization, 
Technical  Communication,  or  Readability  criteria.  I he 
second  constraint  is  that  these  practices,  when  applied, 
cannot  he  measured  with  a grade  level  ol  readability  or 
comprehension.  However,  the  practices  are  expected  to 
generally  improve  user  performance  and  acceptance. 

This  section  presents  approximately  50  practices 
which  you  should  apply  when  rewriting  a manual.  For 


convenience,  this  section  presents  these  practices  in 
seven  sets',  one  set  lor  each  ol  seven  types  ol  manual 
content  as  follows: 

1.  Nontroubleshooting  procedures 

2.  I’roceduralized  troubleshooting  aids 
.'i.  Functional  diagrams 

4.  Schematic  and  wiring  diagrams 

5.  Tables 
().  Graphs 
7.  Pictorials 

Fault  set  is  presented  in  the  lorm  ol  a checklist  which 
contains  abbreviated  statements  of  practices  relevant  to 
the  type  of  material  being  considered.  Since  these 
practices  arc  reasonably  well  known,  no  supporting 
discussion  is  provided. 


NONTROUBLESHOOTING  PROCEDURES  PRACTICES 


p 


I 


— Do  not  use  paragraph  format  for  presenting  instructions. 

— Number  steps  and  arrange  them  in  groups  of  six  or  less. 

— Limit  step  content  to:  25  words  or  less,  two  or  three  thoughts,  or  two  minutes  work. 

— Provide  workstation,  locator,  and  equipment  detail  pictorials. 

— Provide  "input"  page  listing  requirements  for  personnel,  test  equipment,  supplies,  and  equip- 
ment conditions. 

— Use  second  person  imperative  for  narrative  instructions. 

— Use  third  person  indicative  for  Notes,  Cautions,  and  Warnings. 

— Present  Notes,  Cautions,  and  Warnings  before  the  relevant  steps. 

— Use  white  space,  titles,  and  paragraph  format  to  distinguish  Notes,  Cautions,  and  Warnings  from 
instructions. 

— Specify  follow-on  maintenance. 


PROCEDURALIZED  TROUBLESHOOTING  AIDS  PRACTICES 

— Provide  hard  copy  to  facilitate  usage  at  job  site. 

— Use  logic  tree  or  decision  table  formats  to  portray  branching  or  multiple  alternatives. 

— Good  troubleshooting  format  should  include: 

— symptom  statement 

— logic  statement,  viz.,  why  this  upcoming  step 

— abbreviated  action  statement 

— sequence  guidance  via  branching  or  parenthetical  note  • 

— progress  statements  for  each  step  or  interim  conclusion 

— tolerance  standards 

— conclusion  and  corrective  action. 


FUNCTIONAL  DIAGRAMS  PRACTICES 


— Use  direction  arrows  to  show  flow.  Design  flow  to  be  left  to  right  and  top  to  bottom. 

— Omit  detail  within  maintainable  unit. 

— Specify  signal  characteristics/tolerances  in  pictorial  or  tabular  form. 

— Use  height  to  width  ratio  of  two  to  three  for  functional  flow  blocks. 

— Provide  procedural  support  on  how  to  troubleshoot  complex  portions  of  functional  diagram 

— Provide  hardcopy  to  facilitate  signal  tracing. 

— Ensure  that  word  labels  comply  with  minimum  type  size  standards. 


SCHEMATIC  AND  WIRING  DIAGRAM  PRACTICES 


— Show  piece  part  detail  only  when  replacement  is  authorized  at  that  level. 

— Provide  at  least  1/8"  separation  between  parallel  lines. 

— Label  points  of  continuity  between  multiple  page  presentations. 

— Include  superordinate  units. 

— Provide  procedural  help  for  complex  portions  of  wiring  and 
schematic  diagrams. 

— Ensure  that  word  labels  comply  with  minimum  type  size  standards. 

— Provide  hard  copy  to  facilitate  signal  tracing. 


TABLES  PRACTICES 
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— Select  title  to  reflect  content  variables. 

— Provide  fewer  columns  than  rows. 

— Avoid  empty  rows  or  columns. 

— Specify  units  in  column  heads. 

— Arrange  row  entries  in  groups  of  six  or  less. 

— Order  row  entries;  alphabetize  if  necessary. 

— Align  elements  within  column  and  row. 

— Do  not  require  interpolation  in  numerical  look  up  tables. 

— Distinguish  multiple  elements  in  a single  cell,  e.g.,  type  size. 

— Show  at  least  25  percent  white  space. 

— Enclose  table  in  border. 


GRAPHS  PRACTICES 


— Use  graphs  instead  of  tables  where  single  or  double  interpolation  is  required. 

— Use  grid  interval  of  0.3  inches  (0.1  inch  minimum). 

— Use  grid  lines  which  are  0.015  to  0.0125  inch  wide. 

— Orient  axes  naturally,  e.g.,  altitude  on  vertical  axis. 

— Select  title  to  reflect  graph  variables. 

— Enclose  graphs  in  a border. 

— Provide  instructions  and  illustrations  for  using  complex  graphs. 

— Provide  a legend  for  nonstandard  symbols. 
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PICTORIALS  PRACTICES 


When  supporting  procedures,  pictorials  should  progress  from  contextual  to  enlargements  to 
ploded  views. 

Use  pictorials  to  introduce  terminology  used  in  upcoming  equipment  descriptions. 

Use  line  drawings  emphasizing  relevant  items  rather  than  faithful  physical  fidelity. 

Use  pictures  to  portray  waveform  tolerances. 

Present  the  technician's  view;  do  not  use  orientations  he  can't  see. 

Orient  viewer  by  use  of  direction  arrows,  e.g.,  FWD,  REAR. 

Use  arrows  to  indicate  motion. 

Use  arrows  and  (callouts)  to  emphasize  key  points  of  a drawing. 

Limit  callouts  to  seven  or  less. 

Number  callouts  to  correspond  to  instructional  steps. 
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1.  Organization  Requirements 

2.  Technical  Communication  Requirements 

3.  Readability  Requirements 

4.  Summary  Checklists 

5.  General  Rewrite  Practices 

The  first  three  sections  are  developed  in  the  form  of  tests  and 
criteria  to  be  applied  to  a technical  manuscript.  The  fourth 
section  is  a summary  of  the  first  three  sections  in  checklist  form. 
The  final  section  contains  a listing  of  some  good  technical  writing 
practices . 

There  are  two  companion  products  to  the  report.  The  first  is 
a "book  plan"  which  specifies  the  impact  the  requirements  and 
criteria  will  have  on  an  existing  maintenance  manual.  The  second 
is  an  evaluation  plan  for  verifying  the  efficacy  of  the  require- 
ments and  criteria  for  improving  reading  comprehension. 


SECURITY  CLASSIFICATION  OF  This  FAOE(TWi»n  Dal a Bnlarad) 


UNCLASSIFIED 


SECURITY  CLASSIFICATION  OF  THIS  PAGE  fltTlMl  Data  Entered) 


REPORT  DOCUMENTATION  PAGE 

READ  INSTRUCTIONS 

BEFORE  COMPLETING  FORM 

1.  REPORT  NUMBER 

2.  GOVT  ACCESSION  NO. 

3.  RECIPIENT'S  CATALOG  NUMBER 

4.  TITLE  (and  Subtltla) 

Requirements  and  Criteria  for  Improving 
Reading  Comprehension  of  Technical  ^ 

Manuals 

5.  TYPE  OF  REPORT  ft  PERIOD  COVERED 

FINAL 

6.  PERFORMING  ORG.  REPORT  NUMBER 

N/A 

7.  AUTHORfaJ 

Theodore  J.  Post 

Harold  E.  Price 

8.  CONTRACT  OR  GRANT  NUMBERS) 

N00024-74 -05426 

9.  PERFORMING  ORGANIZATION  NAME  ANO  ADDRESS 

BioTechnology , Inc. 

3027  Rosemary  Lane 

Falls  Church,  Virginia  22042 

to.  PROGRAM  ELEMENT.  PROJECT.  TASK 
AREA  ft  WORK  UNIT  NUMBERS 

11.  CONTROLLING  OFFICE  NAME  ANO  ADDRESS 

12.  REPORT  DATE 

November  1974 

13.  NUMBER  OF  PAGES 

65 

14.  MONITORING  AGENCY  NAME  » ADDRESSfff  dlltoront  from  Controlling  Olllco) 

Technical  Publications  Branch,  0463 

Naval  Sea  Systems  Command 

Washington,  D.C. 

15.  SECURITY  CLASS,  (of  thla  raporl) 

Unclassified 

15a.  DECLASSIFICATION/ DOWNGRADING 
SCHEDULE 

16.  DISTRIBUTION  STATEMENT  (ol  thla  Raporl) 

Distribution  of  This  Report  is  Unlimited 

17.  DISTRIBUTION  STATEMENT  (ol  tho  aba  tract  anfaracf  In  Block  30,  II  dfffarant  from  Report) 

18.  SUPPLEMENTARY  NOTES 

19.  KEY  WORDS  (Continue  on  ravarao  alda  If  necaaaary  and  Idantlfy  by  block  numbar) 

Readability  Maintenance  Manuals 

Comprehension  Job  Aids 

Technical  Publications  Information  Presentation 

Technical  Manuals  Technical  Writing 

20.  ABSTRACT  (Contlnua  on  ravaraa  alda  If  nacaaamey  and  Idantlfy  by  block  number) 

"^A  gap  exists  between  the  reading  comprehension  level  of 
technical  manuals  and  the  reading  abilities  of  new  Navy  techni- 
cians. This  report  presents  requirements  and  criteria  to  be  used 
by  technical  writers  to  improve  the  readability  and  comprehensi- 
bility of  their  manuscripts.  The  report  is  presented  in  five 
major  sections  as  follows: 

DD  i jan^7j  1473  EDITION  OF  I NOV  6S  IS  OBSOLETE 
S/N  0 102-014-  6601  | 


UNCLASSIFIED 


SECURITY  CLASSIFICATION  OF  THIS  RAGE  (Whan  Data  Bntarad) 


